<?php

// +----------------------------------------------------------------------
// | WeChatDeveloper
// +----------------------------------------------------------------------
// | 版权所有 2014~2018 广州楚才信息科技有限公司 [ http://www.cuci.cc ]
// +----------------------------------------------------------------------
// | 官方网站: http://think.ctolog.com
// +----------------------------------------------------------------------
// | 开源协议 ( https://mit-license.org )
// +----------------------------------------------------------------------
// | github开源项目：https://github.com/zoujingli/WeChatDeveloper
// +----------------------------------------------------------------------

namespace Itdashu\SwoftThirdPartyService\Service\WeChat;

use Itdashu\SwoftThirdPartyService\Service\WeChat\Contracts\BasicWeChat;

/**
 * 微信粉丝管理
 * Class User
 * @package WeChat
 */
class User extends BasicWeChat
{

  /**
   * 设置用户备注名
   * @param $openid
   * @param $remark
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function updateMark($openid, $remark)
  {
    $url = 'https://api.weixin.qq.com/cgi-bin/user/info/updateremark?access_token=ACCESS_TOKEN';
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, ['openid' => $openid, 'remark' => $remark]);
  }

  /**
   * 获取用户基本信息（包括UnionID机制）
   * @param string $openid
   * @param string $lang
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function getUserInfo($openid, $lang = 'zh_CN')
  {
    $url = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid={$openid}&lang=zh_CN";
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpGetForJson($url);
  }

  /**
   * 批量获取用户基本信息
   * @param array $openids
   * @param string $lang
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function getBatchUserInfo(array $openids, $lang = 'zh_CN')
  {
    $url = 'https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN';
    $data = ['user_list' => []];
    foreach ($openids as $openid) {
      $data['user_list'][] = ['openid' => $openid, 'lang' => $lang];
    }
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, $data);
  }

  /**
   * 获取用户列表
   * @param string $next_openid
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function getUserList($next_openid = '')
  {
    $url = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid={$next_openid}";
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpGetForJson($url);
  }

  /**
   * 获取标签下粉丝列表
   * @param integer $tagid 标签ID
   * @param string $next_openid 第一个拉取的OPENID
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function getUserListByTag($tagid, $next_openid = '')
  {
    $url = 'https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN';
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, ['tagid' => $tagid, 'next_openid' => $next_openid]);
  }

  /**
   * 获取公众号的黑名单列表
   * @param string $begin_openid
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function getBlackList($begin_openid = '')
  {
    $url = "https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN";
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, ['begin_openid' => $begin_openid]);
  }

  /**
   * 批量拉黑用户
   * @param array $openids
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function batchBlackList(array $openids)
  {
    $url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=ACCESS_TOKEN";
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, ['openid_list' => $openids]);
  }

  /**
   * 批量取消拉黑用户
   * @param array $openids
   * @return array
   * @throws Exceptions\InvalidResponseException
   */
  public function batchUnblackList(array $openids)
  {
    $url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=ACCESS_TOKEN";
    $this->registerApi($url, __FUNCTION__, func_get_args());
    return $this->httpPostForJson($url, ['openid_list' => $openids]);
  }

}